<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<!--

    Copyright (c) 2010, 2017 Oracle and/or its affiliates. All rights reserved.

    This program and the accompanying materials are made available under the
    terms of the Eclipse Public License v. 2.0, which is available at
    http://www.eclipse.org/legal/epl-2.0.

    This Source Code may also be made available under the following Secondary
    Licenses when the conditions for such availability set forth in the
    Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
    version 2 with the GNU Classpath Exception, which is available at
    https://www.gnu.org/software/classpath/license.html.

    SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0

-->

	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
	<TITLE></TITLE>
	<META NAME="GENERATOR" CONTENT="StarOffice 8  (Win32)">
	<META NAME="AUTHOR" CONTENT="chiaming">
	<META NAME="CREATED" CONTENT="20080902;14301200">
	<META NAME="CHANGED" CONTENT="20081001;13404559">
</HEAD>
<BODY LANG="en-US" DIR="LTR">
<P><FONT SIZE=4><B>close</B></FONT></P>
<P>The <B>close</B> service request is an http request message sent
to the UMS  in accordance with the Simple Messaging API or the XML
Messaging API.</P>
<P>The <B>close</B> service request must conform to the following
criteria:</P>
<TABLE WIDTH=100% BORDER=1 CELLPADDING=4 CELLSPACING=3>
	<COL WIDTH=128*>
	<COL WIDTH=128*>
	<TR VALIGN=TOP>
		<TD WIDTH=50%>
			<P><B>Required field/attribute values</B></P>
		</TD>
		<TD WIDTH=50%>
			<P><B>Optional field/attribute values</B></P>
		</TD>
	</TR>
	<TR VALIGN=TOP>
		<TD WIDTH=50%>
			<P>service=close</P>
		</TD>
		<TD WIDTH=50%>
			<P><BR>
			</P>
		</TD>
	</TR>
	<TR VALIGN=TOP>
		<TD WIDTH=50%>
			<P>sid=</P>
		</TD>
		<TD WIDTH=50%>
			<P><BR>
			</P>
		</TD>
	</TR>
</TABLE>
<P><A NAME="wfdi"></A><A NAME="krcn"></A><B><BR>Notes:<BR></B><BR>The
<B>close</B> service request is used to close the UMS client session
that was created with a <B>login</B> service request. A <B>close</B>
service request message MUST contain an sid attribute with its value
set to the secure token obtained from the previous <A HREF="http://niagra2.sfbay.sun.com:8080/ums/login_reply.html"><B>login_reply</B></A><B>
</B><SPAN STYLE="font-weight: medium">response</SPAN><B> </B>message.</P>
<P>Service response message: <B><A HREF="./close_reply.html">close_reply</A><BR><BR><FONT SIZE=3 STYLE="font-size: 13pt">1.
Simple Messaging API Example: </FONT></B>
</P>
<P>The following is a <B>close</B> service request message.<BR><BR>POST
/ums/simple?service=close&amp;sid=2-LTgxMDczMTczNQ==  HTTP/1.1
<BR>Content-Type: text/plain;charset=UTF-8 <BR>User-Agent:
Java/1.6.0_07 <BR>Host: localhost:8888 <BR>Accept: text/html,
image/gif, image/jpeg, *; q=.2, */*; q=.2 <BR>Connection: keep-alive
<BR>Content-Length: 0 <FONT SIZE=4><BR><BR></FONT><B><FONT SIZE=3 STYLE="font-size: 13pt">2.
XML Messaging API Example:</FONT></B></P>
<P><SPAN STYLE="font-weight: medium"><FONT SIZE=3>The following is a
<B>close</B> service request message.</FONT></SPAN><B><FONT SIZE=4><BR><BR></FONT></B>POST
/ums/xml HTTP/1.1 <BR>Accept: text/xml, text/html, image/gif,
image/jpeg, *; q=.2, */*; q=.2 <BR>Content-Type: text/xml;
charset=utf-8 <BR>Content-Length: 370 <BR>SOAPAction: &quot;&quot;
<BR>Cache-Control: no-cache <BR>Pragma: no-cache <BR>User-Agent:
Java/1.6.0_07 <BR>Host: localhost:8888 <BR>Connection: keep-alive
<BR><BR>&lt;SOAP-ENV:Envelope
xmlns:SOAP-ENV=&quot;<A HREF="http://schemas.xmlsoap.org/soap/envelope/">http://schemas.xmlsoap.org/soap/envelope/</A>&quot;&gt;<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;SOAP-ENV:Header&gt;<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;ums:MessageHeader
xmlns:ums=&quot;https://mq.java.net/ums&quot; ums:id=&quot;1.0&quot;
ums:version=&quot;1.0&quot;&gt;<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;ums:Service
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ums:service=&quot;close&quot;
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ums:sid=&quot;2-LTgxMDczMTczNQ==&quot;/&gt;<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/ums:MessageHeader&gt;<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/SOAP-ENV:Header&gt;<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;SOAP-ENV:Body/&gt;<BR>&lt;/SOAP-ENV:Envelope&gt;<BR><BR><A HREF="./protocol.html">Back
to UMS protocol page.</A></P>
</BODY>
</HTML>
